<?php
// $Id: users.php @2009 ccbox.net 1:22 2009-5-14 $

/**
 * Users 封装来自 sys_acl_users 数据表的记录及领域逻辑
 */
class Admin_Users extends QDB_ActiveRecord_Abstract
{
	// #####################################
	/**
	 * 取得用户角色id和角色名(array)
	 * @param array $tags
	 * @return String
	 */
	static function getRoles($roles)
	{
		if (is_array($roles) || $roles instanceof Iterator)
		{
			$arr = array();
			foreach ($roles as $role)
			{
				$arr[$role->role_id] = $role->rolename;
			}
			$roles = $arr;
		}
		//return trim(implode(' ', Q::normalize($roles, ' ')));
		return $roles;
	}
	/**
	* 设置用户的角色
	* @param mixed $roles
	* 
	$roles = array(
		'0' => '1',
		'1' => '3',
		'2' => '4',
		);
		///这个函数未完成
	*/
	function setRoles($roles)
	{
		$return_value = array();
		foreach ( $roles as $role )
		{
			$return_value[] = Admin_Roles::find('role_id = ?', $role )->query();
		}
		$this->_props['roles'] = $return_value;
		$this->willChanged('roles');
	}

	// #####################################
	/**
	 * 创建属于当前用户的任务
	 *
	 * @return Task
	 */
	function createTask($form_value)
	{
		$task = new Task_Task($form_value);
		//$task->changeProps($form_value);
		$task->owner_info = $this;
		$task->class_a = $this->group->group_id;
		dump ($task);
		//echo "<br>--------------<br>";
		return $task;
	}

	// #####################################
	function getDate($name){
		return $this->_props[$name] > 0 ? date('Y-m-d', $this->_props[$name]) : '';
	}
	function setDate($value,$name)
	{
		$this->_props[$name] = strtotime($value) ? strtotime($value) : 0;
		$this->willChanged($name);
	}

	// #####################################
	function getGroupName(){
		$this_goup = Admin_Groups::find('group_id = ?',$this->_props['group_id'])->query();
		return $this_goup->group_name;
		//return 'this is the group name------------------------';
	}

	// #####################################

	/**
	 * 返回对象的定义
	 *
	 * @static
	 *
	 * @return array
	 */

	static function __define()
	{
		return array
		(
			// 指定该 ActiveRecord 要使用的行为插件
			'behaviors' => 'acluser',

			// 指定行为插件的配置
			'behaviors_settings' => array
			(
				# '插件名' => array('选项' => 设置),
				//ipzone, email, mobile, phone, join_day, dimission_day, birthday,
				// user_id, group_id, account, user_name, password, created, updated, is_locked, register_ip, last_login, last_login_ip, login_count
				'acluser' => array(
					//'encode_type' => 'crypt',			 	//encode_type: 密码的加密方式，默认值为 crypt

					'username_prop'		=> 'account',		//指示在模型中使用哪一个属性来保存的用户名，默认值为 username。 
					'password_prop'		=> 'password',		//指示在模型中使用哪一个属性来保存用户密码，默认值为 password。

					'roles_enabled'		=> true,		//是否启用对关联角色的支持，默认值为 false。 
					'roles_prop'		=> 'roles',		//角色信息映射到用户模型的哪一个属性之上。默认值为 roles。
					'roles_name_prop'	=> 'rolename',		//指示角色模型使用哪一个属性保存角色名称，默认值为 name。

					'acl_data_props'	=> 'user_id,account,user_name,roles,group_id,group_name,is_locked',
							//指示在使用 aclData() 方法时，返回的数组中要包含哪些属性，默认值为 uesrname。

					//'unique_username'   	=> true,	 		//指示是否检查用户名的唯一性，默认值为 true

					'update_login_auto' 	=> true,		//是否在成功调用 validateLogin() 后自动更新用户信息，默认值为 false
					'update_login_count_prop' => 'login_count',	//记录登录次数的属性，不指定则不更新
					'update_login_at_prop'	=> 'last_login',	//记录登录时间的属性，不指定则不更新
					'update_login_ip_prop'	=> 'last_login_ip',	//记录登录 IP 的属性，不指定则不更新

					'register_save_auto' => true,			//是否在新建用户对象时，自动保存下列信息，默认值为 false
					'register_ip_prop' => 'register_ip',		//记录用户的 IP 地址
					'register_at_prop' => 'created',		// 记录创建时间 
				),
			),

			// 用什么数据表保存对象
			'table_name' => 'sys_acl_users',

			// 指定数据表记录字段与对象属性之间的映射关系
			// 没有在此处指定的属性，QeePHP 会自动设置将属性映射为对象的可读写属性
			'props' => array
			(
				// 主键应该是只读，确保领域对象的“不变量”
				'user_id' => array('readonly' => true),

				// 对象创建时间应该是只读
				'created' 	=> array('readonly' => true),
				'register_ip' 	=> array('readonly' => true),

				// 对象最后更新时间应该是只读
				'updated' 	=> array('readonly' => true),

				/**
				 *  可以在此添加其他属性的设置
				 */
				'group_name' 	=> array('getter'=>'getGroupName'),

				/**
				 * 添加对象间的关联
				 */
				# 'other' => array('has_one' => 'Class'),
				// ***************** ACL部分关联开始 *****************
				//用户只属于一个组
				'group' => array(QDB::BELONGS_TO => 'admin_groups', 'source_key' => 'group_id'),
				//用户拥有一个或者多个角色
				'roles' => array(
					QDB::MANY_TO_MANY=> 'admin_roles',
					'setter'	 => 'setRoles',
					'mid_source_key' => 'user_id',
					'mid_target_key' => 'role_id',
					'mid_table_name' => 'sys_acl_users_have_roles'
				),
				//用户除了角色和分组之外还可以拥有多个额外的权限
				'permissions' => array(
					QDB::MANY_TO_MANY=> 'admin_permissions',
					'mid_source_key' => 'user_id',
					'mid_target_key' => 'permission_id',
					'mid_table_name' => 'sys_acl_users_have_permissions'
				),
				// ***************** ACL部分关联结束 *****************
			),

			/**
			 * 允许使用 mass-assignment 方式赋值的属性
			 *
			 * 如果指定了 attr_accessible，则忽略 attr_protected 的设置。
			 */
			'attr_accessible' => '',

			/**
			 * 拒绝使用 mass-assignment 方式赋值的属性
			 */
			'attr_protected' => 'user_id',

			/**
			 * 指定在数据库中创建对象时，哪些属性的值不允许由外部提供
			 *
			 * 这里指定的属性会在创建记录时被过滤掉，从而让数据库自行填充值。
			 */
			'create_reject' => '',

			/**
			 * 指定更新数据库中的对象时，哪些属性的值不允许由外部提供
			 */
			'update_reject' => '',

			/**
			 * 指定在数据库中创建对象时，哪些属性的值由下面指定的内容进行覆盖
			 *
			 * 如果填充值为 self::AUTOFILL_TIMESTAMP 或 self::AUTOFILL_DATETIME，
			 * 则会根据属性的类型来自动填充当前时间（整数或字符串）。
			 *
			 * 如果填充值为一个数组，则假定为 callback 方法。
			 */
			'create_autofill' => array
			(
				# 属性名 => 填充值
				'is_locked' => 0,				//注册时默认帐号为锁定状态
				'created' => self::AUTOFILL_TIMESTAMP ,		//自动填充建立时间
				'updated' => self::AUTOFILL_TIMESTAMP ,		//自动填充更新时间
			),

			/**
			 * 指定更新数据库中的对象时，哪些属性的值由下面指定的内容进行覆盖
			 *
			 * 填充值的指定规则同 create_autofill
			 */
			'update_autofill' => array
			(
				//'updated' => self::AUTOFILL_TIMESTAMP ,	  //自动填充更新时间，但是设置了自动记录用户登录信息，所以每次用户登录都会自动填充，无法反映真实情况
			),

			/**
			 * 在保存对象时，会按照下面指定的验证规则进行验证。验证失败会抛出异常。
			 *
			 * 除了在保存时自动验证，还可以通过对象的 ::meta()->validate() 方法对数组数据进行验证。
			 *
			 * 如果需要添加一个自定义验证，应该写成
			 *
			 * 'title' => array(
			 *		array(array(__CLASS__, 'checkTitle'), '标题不能为空'),
			 * )
			 *
			 * 然后在该类中添加 checkTitle() 方法。函数原型如下：
			 *
			 * static function checkTitle($title)
			 *
			 * 该方法返回 true 表示通过验证。
			 * regex 用正则验证
			 */

			//ipzone, email, mobile, phone, join_day, dimission_day, birthday,
			// user_id, group_id, account, user_name, password, created, updated, is_locked, register_ip, last_login, last_login_ip, login_count

			'validations' => array
			(
				'group_id' => array
				(
					array('is_int', '所在组别必须是一个整数'),
				),

				'account' => array
				(
					array('not_empty', '登录帐号不能为空'),
					array('min_length', 5, '登录帐号不能少于 5 个字符'),
					array('max_length', 20, '登录帐号不能超过 20 个字符'),
					array('is_alnumu', '登录帐号名只能由字母、数字或下划线组成'),
					array(array('Admin_Users','validatePassword'),'登录帐号名不能由下划线开始和结束'),
				),

				'user_name' => array
				(
					array('not_empty', '姓名不能为空'),
					array('regex', "/^([\x80-\xff]*)$/", '姓名必须是中文字符'),
					//array('regex', "/^[u4e00-u9fa5]*$/", '姓名必须是中文字符'),
					array('min_length', 4, '姓名不能少于两个字'),
					array('max_length', 12, '姓名不能超过四个字'),
				),

				'password' => array
				(
					array('not_empty', '登录密码不能为空'),
					array('min_length', 5, '登录密码不能少于 5 个字符'),
					array('max_length', 50, '登录密码不能超过 50 个字符'),
				),

				'register_ip' => array
				(
					array('max_length', 15, '注册IP不能超过 15 个字符'),
				),

				'last_login' => array
				(
					array('is_int', '最后登录时间必须是一个整数'),
				),

				'last_login_ip' => array
				(
					array('max_length', 15, '最后登录IP不能超过 15 个字符'),
				),

				'login_count' => array
				(
					array('is_int', '登录次数必须是一个整数'),
				),

			),
		);
	}



/* ------------------ 以下是自动生成的代码，不能修改 ------------------ */

	/**
	 * 开启一个查询，查找符合条件的对象或对象集合
	 *
	 * @static
	 *
	 * @return QDB_Select
	 */
	static function find()
	{
		$args = func_get_args();
		return QDB_ActiveRecord_Meta::instance(__CLASS__)->findByArgs($args);
	}

	/**
	 * 返回当前 ActiveRecord 类的元数据对象
	 *
	 * @static
	 *
	 * @return QDB_ActiveRecord_Meta
	 */
	static function meta()
	{
		return QDB_ActiveRecord_Meta::instance(__CLASS__);
	}

	static function validatePassword($password)
	{
		$along=strlen($password);
		//傻傻的验证规则 ^_^
		//if(strlen($password)!=7){return false;}
		if(preg_match('/[_]/',substr($password,0,1))){return false;}
		//if(preg_match('/[^0-9]/',substr($password,2,4))){return false;}
		if(preg_match('/[_]/',substr($password,($along-2),($along-1)))){return false;}
		return true;
	}


/* ------------------ 以上是自动生成的代码，不能修改 ------------------ */

}

